This ReadMe file describes the MiniExamples available in the DatabaseKit directory. Each MiniExample is stored as a separate ".compressed" file. The MiniExamples are only available via anonymous ftp or email (and only if you can receive NeXTmail).
Since ".compressed" is a binary format, remember to switch to binary mode (type "bin" at the command line) when fetching via ftp.
This file was last updated: 11/10/93
DATABASEKIT MINIEXAMPLES
AddressBook example
In order to run this example, you need to have a SYBASE server with a pubs database installed. [The pubs database is a sample database provided with the SYBASE limited server package.] After you are properly connected to the Sybase server, you can perform operations such as Select, Insert, Update or Delete.
AssociationExample example
The current version of DBKit does not provide a way to filter the records fetched by a detail FetchGroup. DBKit does not allow a qualifier to be built into a relationship, nor does it allow a qualifier to be permanently attached to a FetchGroup. The Association example provides a way to do filtering of detail records by using a subclass of DBAssociation that replaces the default association which exists between the master FetchGropu and the detail FetchGroup.
BarChart palette
This palette demonstrates how to use your custom UI objects with the DBKit. It illustrates in particular the DBCustomAssociation protocol which allows you to retrieve or set values to your database via a custom view objects.
BooleanFormatter example
This example shows how to substitute the default display format in the TableView to your own format by subclassing the DBFormatter class. In order to run this example you need to have an ORACLE server with a demo database installed.
DateFormatter example
This example shows how to create a formatter for a DBTableView that uses a subclass of TextFieldCell to validate the user's input. The formatter forces the user to type in values of the form xx/xx/xx. In order to run this example, you need to have an adaptor, a model and a data source.
DocumentPalette palette (3.1 only)
This palette is a subclass of Control. It shows how to conveniently store files into the database using their absolute pathnames, instead of the data associated with them, and let the WorkSpace do the work for opening or reading the files. You can also drop a file into the document well, and double-click to open it for reading.
OrderByTest example
This example shows you how to change the sort order every time the columns in the tableview are rearranged. In order to run this example, you need to have an ORACLE server with a demo database installed.
RadioAssociation source code
These two files allow you to make a matrix of radio buttons sychronize with the boolean data type of your database.
TablePrinterPalette palette (3.1 only)
An InterfaceBuilder palette which nicely formats and prints DBTableViews.
TableView example
This example shows how you can define a DBTableView and a DBModule programmatically instead of using the corresponding IB objects. It also shows how you can change the sort order every time the columns in the tableview are rearranged.